Miles Sound System SDK 7.2a

Utility Services

Discussion

provide many functions that used to be standalone utilities in previous versions of the Miles Sound System. Now that this technology is available as part of the general MSS library, you can add some neat new features to your applications. You could, for example, leave your MIDI sequences in standard MIDI formatted files and only convert them to XMIDI at playback time. This would let your users edit and add new MIDI files to your application!

These functions were used to create the new Miles Sound Studio application. The source code for this utility (found in \src\tools) is an excellent place to look for sophisticated examples of these functions.

Note that you may never have to even use any of these functions, since many can be performed offline with the Miles Sound Studio.

Utility Services
AIL_file_type	returns the file type of the specified file image.
MILES_FILE_TYPE	describes the type of a file.
AIL_file_type_named	returns the file type of the specified file image using a filename hint.
AIL_WAV_info	retrieves the audio format information for the specified file image.
AILSOUNDINFO	specifies audio format details.
AIL_process_digital_audio	provides high-level access to the Miles sound mixer.
AILMIXINFO
AIL_size_processed_digital_audio	provides a way to determine how much output memory is necessary for a given set of input mix data.
AIL_compress_ADPCM	compresses the digital sound described by the info structure into an IMA ADPCM wave file image.
AIL_decompress_ADPCM	decompresses the IMA ADPCM digital sound described by the info structure into a standard PCM wave file image.
AIL_compress_ASI	compresses a digital sound with an ASI encoder capable of writing the file type described by the filename_ext parameter.
AILLENGTHYCB	specifies a user-defined callback that gets called during lengthy Miles operations.
MILES_LENGTHY_STATE	indicates the current stage of the lengthy operation.
AILCODECSETPROP	provides a way for ASI properties to be set during a compression or decompression.
AIL_decompress_ASI	decompresses a digital sound with the ASI decoder for the passed file extension and returns a standard PCM wave file image.
AIL_MIDI_to_XMI	converts Standard MIDI Format 0 and Format 1 sequence files to the Extended MIDI (XMIDI) format.
MILES_MIDI_TO_XMI_FLAGS	specifies optional conversion flags for the AIL_MIDI_to_XMI function.
AIL_compress_DLS	compresses a DLS file with either IMA ADPCM compression or with an ASI encoder specified by the compress_ext parameter.
AIL_extract_DLS	extracts and decompresses the DLS data from a loaded MLS file or merged XMIDI file.
AIL_find_DLS	returns pointers and sizes to the DLS and XMIDI chunks inside a merged XMIDI file image.
AIL_merge_DLS_with_XMI	merges an XMIDI file and a DLS or MLS file together.
AIL_filter_DLS_with_XMI	filters out unused instruments in a DLS file given one or more XMIDI files.
MILES_FILTER_DLS_FLAGS	specifies options to use when filtering DLS instrument sets with an XMIDI file.
AIL_list_MIDI	creates a detailed listing of a MIDI file.
MILES_LIST_MIDI_FLAGS	specifies flags to use when listing a MIDI file.
AIL_list_DLS	creates a detailed listing of a DLS or MLS file.
MILES_LIST_DLS_FLAGS	specifies flags to use when listing a DLS file.
AIL_inspect_MP3	obtains some basic information about the structure of an MPEG-1 Layer 3 audio file, and prepares for optional header enumeration.
AIL_enumerate_MP3_frames	obtains information about successive frames from an MPEG-1 Layer 3 audio file.
MP3_INFO